home *** CD-ROM | disk | FTP | other *** search
/ Sun Solutions 2000 #2 / Sun Solutions CD (Volume 2 2000)(Special Focus - Java Technologies)(Disc 1).ISO / products / bin / java2 / Solaris_2 / README < prev   
Text File  |  2000-01-05  |  12KB  |  270 lines
  1.  
  2.                                 README
  3.  
  4.                    The Java(R) 2 Runtime Environment
  5.                      Standard Edition Version 1.2.1
  6.                           
  7.  
  8.  
  9. The Java(R) 2 runtime environment contains the Java virtual machine, 
  10. runtime class libraries, and Java application launcher that are 
  11. necessary to run programs written in the Java progamming language. 
  12. It is not a development environment and doesn't contain development 
  13. tools such as compilers or debuggers. For development tools, see the 
  14. Java 2 SDK Standard Edition.  
  15.  
  16. The Win32 version of the Java 2 runtime environment includes the Java 
  17. Plug-in product which enables support for the Java 2 platform on 
  18. recent releases of Netscape Navigator and Microsoft Internet Explorer. 
  19. When you install the Java 2 runtime environment, you can install the 
  20. Plugin as well. For more information, including information about the 
  21. Java Plug-in for Solaris, see the Plug-in web page at 
  22. http://java.sun.com/products/plugin/.
  23.  
  24. The Win32 version of the Java 2 runtime environemnt includes a 
  25. Symantec JIT compiler, Copyright (c) 1996-1999 by Symantec 
  26. Corporation. All rights reserved.
  27.  
  28. =======================================================================
  29.     Deploying Java Applications with the Java 2 Runtime Environment
  30. =======================================================================
  31.  
  32. An Java-language application, unlike an applet, cannot rely on a web 
  33. browser for installation and runtime services. When you deploy a Java 
  34. application, your software bundle will probably consist of the 
  35. following parts: 
  36.  
  37.             Your own class, resource, and data files. 
  38.             A runtime environment. 
  39.             An installation procedure or program. 
  40.  
  41. You already have the first part, of course. The remainder of this
  42. document covers the other two parts. See also the Notes for Developers 
  43. page on the Java Software website:
  44.  
  45.      http://java.sun.com/products/jdk/1.2/runtime.html
  46.  
  47. -----------------------------------------------------------------------
  48. Runtime Environment
  49. -----------------------------------------------------------------------
  50.  
  51. To run your application, a user needs a Java virtual machine, the Java 
  52. platform core classes, and various support programs and files. This 
  53. collection of software is known as a runtime environment. 
  54.  
  55. The Java 2 SDK software can serve as a runtime environment. However, 
  56. you probably can't assume your users have the Java 2 SDK software 
  57. installed, and your Java 2 SDK software license doesn't allow you to 
  58. redistribute SDK software files. 
  59.  
  60. To solve this problem, Sun provides the Java 2 runtime environment 
  61. as a free, redistributable runtime environment, available for Win32 and 
  62. Solaris systems. (The Java 2 runtime environment should not be confused 
  63. with the Java 2 SDK's own internal, non-redistributable version of the 
  64. runtime environment housed in the jdk1.2/jre directory.)  
  65.  
  66. The Win32 versions comes with a built-in installation program
  67. suitable for end-users. Solaris versions require the developer to
  68. provide installation support. 
  69.  
  70. The Java 2 runtime environment for Win32 is available both with and 
  71. without international support. The non-international version is much 
  72. smaller, but is suitable only for English-speaking users. 
  73.  
  74. The final step in the deployment process occurs when the software is 
  75. installed on individual user system. Installation consists of copying 
  76. software onto the user's system, then configuring the user's system to 
  77. support that software. 
  78.  
  79. This step includes installing and configuring the runtime environment. 
  80. If you use the Java 2 runtime environment, you must make sure that your 
  81. installation procedure never overwrites an existing installation, unless 
  82. the existing runtime environment is an older version. 
  83.  
  84. The Win32 version of the Java 2 runtime environment is distributed as a 
  85. self-installing executable. A simple way to redistribute the Java 2 
  86. runtime environment is to include this executable in your software 
  87. bundle. You can then have your installation program run the executable, 
  88. or simply instruct the user to install the Java 2 runtime environment 
  89. before installing the rest of your bundle. 
  90.  
  91. The Win32 installation program records program information in the 
  92. Windows Registry. This registry information includes the software 
  93. version, which you should compare with the Java 2 runtime environment 
  94. version in your software bundle. For more information, refer to the 
  95. Notes for Developers on the Java Software web site:
  96.  
  97.      http://java.sun.com/products/jdk/1.2/runtime.html 
  98.  
  99. A more sophisticated approach is to install the Java 2 runtime
  100. environment on your own system, then copy the files you need into your 
  101. own installation set for redistribution. If you choose this approach, 
  102. you must include all files except those described as "optional" in the 
  103. "Redistrubition of the Java 2 runtime environment" section of this 
  104. README. The Java 2 Runtime Environment software can only be 
  105. redistributed if all "required" files are included. See the LICENSE 
  106. file for specifics. 
  107.  
  108. If you use this approach, do not try to emulate the installation steps 
  109. performed by the Java 2 Runtime Environment installer. You might "break" 
  110. an existing runtime environment installation by missing a new or 
  111. undocumented installation step. Instead, you should include the Java 2
  112. Runtime Environment files in your own application directory. In 
  113. effect, your application has its own "private" copy of the Java 2 
  114. Runtime Environment. 
  115.  
  116. The Win32 Java 2 Runtime Environment now includes Java Plug-in software, 
  117. which enables Netscape Navigator and Microsoft Internet Explorer to 
  118. support the Java 2 platform. To develop applets that use Java Plug-in 
  119. software, see the Java Plug-in product page on the Java Software web 
  120. site:
  121.  
  122.      http://java.sun.com/products/plugin/
  123.  
  124. You can also find information about the Java Plug-in for Solaris on 
  125. this web page.
  126.  
  127. -----------------------------------------------------------------------
  128. Winsock Deployment
  129. -----------------------------------------------------------------------
  130.  
  131. If your application uses the networking classes, it may not run 
  132. reliably under Winsock 1.1. If your networking application must support 
  133. Windows 95, which includes Winsock 1.1, you will want to include a 
  134. Winsock 2.0 install in your installation procedure. (Windows NT 4.0 and 
  135. Windows 98 include Winsock 2.0.) To provide Winsock 2.0, you need the 
  136. Microsoft Windows Sockets 2.0 Software Development Kit. This free 
  137. software can be downloaded from the following addresses: 
  138.  
  139.     http://www.microsoft.com/win32dev/netwrk/winsock2/ws295sdk.html
  140.     ftp://ftp.microsoft.com/bussys/WinSock/winsock2/
  141.  
  142.  
  143.  
  144. =======================================================================
  145.           Redistribution of this Java 2 Runtime Environment
  146. =======================================================================
  147. The term "vendors" used here refers to licensees, developers, and 
  148. independent software vendors (ISVs) who license and distribute the 
  149. Java 2 runtime environment with their programs.
  150.  
  151. Vendors may not redistribute this Java 2 runtime environment except in 
  152. the limited circumstances described in the accompanying Binary Code 
  153. License agreement, contained in the LICENSE file in the download 
  154. bundle. 
  155.  
  156. Vendors must follow the terms of the Binary Code License agreement  
  157. which include, among others:
  158.  
  159.  - Arbitrary subsetting of the Java 2 runtime environment is not 
  160.    allowed. See the section below entitled "Required vs. Optional Files" 
  161.    for those files that may be optionally omitted from redistributions 
  162.    of the runtime environment. 
  163.  
  164.  - You must include in your product's license the provisions called 
  165.    out in the Binary Code license.
  166.  
  167. -----------------------------------------------------------------------
  168. Required vs. Optional Files
  169. -----------------------------------------------------------------------
  170. Licensees must follow the terms of the accompanying LICENSE.  
  171.  
  172. The files that make up the Java 2 runtime environment are divided into 
  173. two categories: required and optional.  Files that are marked "optional" 
  174. here do not need to be included in redistributions of the Java 2 
  175. runtime environment with the licensee's program.  
  176.  
  177. The following sections contain lists of the files, for both Win32 
  178. and Solaris platforms, that may optionally be omitted from 
  179. redistributions with the Java 2 runtime environment.  All files not 
  180. in these lists of optional files must be included in redistributions 
  181. of the runtime environment.
  182.  
  183. The Java 2 runtime environment includes the bin and lib directories 
  184. which both must reside in the same directory, called <runtime-dir> in 
  185. the lists below. All paths are relative to the <runtime-dir> directory.
  186.  
  187. Note that in the case of the Win32 Java 2 runtime environment, the 
  188. native code C runtime library, msvcrt.dll, is located in the Windows 
  189. system directory. The location of this directory varies on different 
  190. operating systems, but is usually
  191.  
  192.    - winnt\system32 on Windows NT
  193.    - windows98\system on Windows 98
  194.    - windows\system on Windows 95
  195.  
  196. This file should be included in redistributions of the Win32 version 
  197. of the Java 2 runtime environment.
  198.  
  199. -----------------------------------------------------------------------
  200. Win32 Optional Files and Directories
  201. -----------------------------------------------------------------------
  202. All font properties files in the lib directory other than the default 
  203. lib\font.properties file are optional, and vendors may choose not to 
  204. include them in redistributions of the Java 2 Runtime Environment. In 
  205. addition, the following may be optionally excluded from redistributions:
  206.  
  207. bin\beans.ocx              
  208.    Plugin ActiveX control
  209. lib\jaws.jar              
  210.    Plugin classes
  211. lib\i18n.jar                  
  212.    Character conversion classes and all other locale support
  213. lib\ext\                      
  214.    Directory containing extension jar files
  215. bin\symcjit.dll               
  216.    JIT compiler
  217. bin\rmid.exe
  218.    Java RMI Activation System Daemon
  219. bin\rmiregistry.exe
  220.    Java Remote Object Registry
  221. bin\tnameserv.exe
  222.    Java IDL Name Server
  223. bin\keytool.exe
  224.    Key and Certificate Management Tool
  225. bin\policytool.exe
  226.    Policy File Creation and Management Tool
  227.  
  228.  
  229. -----------------------------------------------------------------------
  230. Solaris Optional Files and Directories
  231. -----------------------------------------------------------------------
  232. The directory <sys> varies depending on the hardware architecture 
  233. implementation.  It will be either sparc or i386. The Solaris version 
  234. of the Java 2 runtime environment ships with support for both green 
  235. threads and native threads. Files providing this support are in the 
  236. directories lib/<sys>/green_threads and lib/<sys>/native_threads 
  237. respectively.  Although at least one of these directories and its 
  238. contents must be included in redistributions of the Java 2 runtime 
  239. environment, vendors do not have to include both. 
  240.  
  241. All font properties files in the lib directory other than the default 
  242. lib/font.properties file for Solaris 2.6 and the default 
  243. lib/font.properties.5.5.1 file for Solaris 2.5.1 are optional, and 
  244. vendors may choose not to include them in redistributions of the 
  245. Java 2 runtime environment. In addition, the following may be 
  246. optionally excluded from redistributions:
  247.  
  248. lib/i18n.jar                  
  249.    Character conversion classes and all other locale support
  250. lib/<sys>/libsunwjit.so       
  251.    JIT compiler
  252. lib/ext/                      
  253.    Directory containing extension jar files
  254. bin/rmid
  255.    Java RMI Activation System Daemon
  256. bin/rmiregistry
  257.    Java Remote Object Registry
  258. bin/tnameserv
  259.    Java IDL Name Server
  260. bin/keytool
  261.    Key and Certificate Management Tool
  262. bin/policytool
  263.    Policy File Creation and Management Tool
  264.  
  265. -----------------------------------------------------------------------
  266. Copyright (c) 1998-1999 Sun Microsystems(tm), Inc.
  267. 901 San Antonio Road, Palo Alto, CA 94303-4900
  268. All rights reserved.
  269.  
  270.